Istruzioni per il deployment del prototipo.

Il prototipo  composto da una Applicazione Web (compatibile Java Servlet 2.4), che deve essere installata su di
un servlet container.

Per rendere attivo il sistema basta:
1) Eseguire il deployment di node.war su di un node container, 
per eseguire il programma client di test senza ricompilarlo bisogna che risponda alla URL http://localhost/node1/

2) Aprire la pagina web http://localhost/node1/ e verificare che l'applicazione effettivamente sia stata inizializzata (basta che si riesca a caricare la home page)

3) Eseguire il file test.bat (lo script suppone che Java sia nel PATH di sistema) e verificare nella amministrazione Web che venga creata una coda "coda1" e venga riempita di messaggi



Per verificare le qualit di replicazione 
1) installare node.war sullo stesso container in un altro contesto ad esempio /node2
2) Aprire la pagina di gestione del nodo ed indicare nella opzione "Join Group" l'URL base del primo nodo 
(se sono state seguite le istruzioni di prima il path indicato dovrebbe gi andare bene)
3) Cliccare su "JOIN"
4) Verificare facendo un refresh che nella lista in basso dei nodi nel gruppo compaiano entrambi i nodi, ordinati per priorit decrescente.
5) Eseguire nuovamente il test.bat e verificare che la coda venga creata su entrambi i nodi ed i messaggi vengano conservati su entrambi i nodi con lo stesso ordinamento

Ovviamente si pu provare con pi di due nodi, si pu anche provare a "spegnere" un nodo durante l'esecuzione del test per testare le capacit di fault-tolerance


L'API lato client si utilizza semplicemente includendo nel classpath il file qms.0.3.jar e instanziando un oggetto di classe qms.client.QMSClient, il cui utilizzo  molto semplice visti i nomi dei metodi.
Si faccia pure riferimento ai JavaDocs inclusi nel pacchetto.

Il file build.xml pu essere utilizzato con Apache ANT per la ricompilazione del pacchetto e la generazione dei Javadocs


Enrico Olivelli

enrico.olivelli@tin.it
347 6407684